package com.zjcloud.jwgl.service;

import java.util.List;
import java.util.Map;
import com.zjcloud.jwgl.domain.JwglScheduleTask;

/**
 * 智能排课任务Service接口
 * 
 * @author zjcloud
 * @date 2024-12-19
 */
public interface IAcScheduleTaskService 
{
    /**
     * 查询智能排课任务
     * 
     * @param id 智能排课任务主键
     * @return 智能排课任务
     */
    public JwglScheduleTask selectAcScheduleTaskById(Long id);

    /**
     * 查询智能排课任务列表
     * 
     * @param acScheduleTask 智能排课任务
     * @return 智能排课任务集合
     */
    public List<JwglScheduleTask> selectAcScheduleTaskList(JwglScheduleTask acScheduleTask);

    /**
     * 新增智能排课任务
     * 
     * @param acScheduleTask 智能排课任务
     * @return 结果
     */
    public int insertAcScheduleTask(JwglScheduleTask acScheduleTask);

    /**
     * 修改智能排课任务
     * 
     * @param acScheduleTask 智能排课任务
     * @return 结果
     */
    public int updateAcScheduleTask(JwglScheduleTask acScheduleTask);

    /**
     * 批量删除智能排课任务
     * 
     * @param ids 需要删除的智能排课任务主键集合
     * @return 结果
     */
    public int deleteAcScheduleTaskByIds(Long[] ids);

    /**
     * 删除智能排课任务信息
     * 
     * @param id 智能排课任务主键
     * @return 结果
     */
    public int deleteAcScheduleTaskById(Long id);

    /**
     * 创建排课任务
     * 
     * @param taskName 任务名称
     * @param semester 学期
     * @param configData 配置数据
     * @return 任务ID
     */
    public Long createScheduleTask(String taskName, String semester, Map<String, Object> configData);

    /**
     * 创建排课任务（支持学期ID）
     * 
     * @param taskName 任务名称
     * @param semesterId 学期ID
     * @param semester 学期名称
     * @param configData 配置数据
     * @return 任务ID
     */
    public Long createScheduleTask(String taskName, Long semesterId, String semester, Map<String, Object> configData);

    /**
     * 启动排课任务
     * 
     * @param taskId 任务ID
     * @return 结果
     */
    public boolean startScheduleTask(Long taskId);

    /**
     * 停止排课任务
     * 
     * @param taskId 任务ID
     * @return 结果
     */
    public boolean stopScheduleTask(Long taskId);

    /**
     * 更新任务进度
     * 
     * @param taskId 任务ID
     * @param progress 进度百分比
     * @return 结果
     */
    public boolean updateTaskProgress(Long taskId, Integer progress);

    /**
     * 完成任务
     * 
     * @param taskId 任务ID
     * @param resultData 结果数据
     * @return 结果
     */
    public boolean completeTask(Long taskId, Map<String, Object> resultData);

    /**
     * 任务失败
     * 
     * @param taskId 任务ID
     * @param errorMessage 错误信息
     * @return 结果
     */
    public boolean failTask(Long taskId, String errorMessage);

    /**
     * 根据学期查询任务列表
     * 
     * @param semester 学期
     * @return 任务列表
     */
    public List<JwglScheduleTask> selectTasksBySemester(String semester);

    /**
     * 查询正在执行的任务
     * 
     * @return 任务列表
     */
    public List<JwglScheduleTask> selectRunningTasks();

    /**
     * 获取任务状态
     * 
     * @param taskId 任务ID
     * @return 任务状态信息
     */
    public Map<String, Object> getTaskStatus(Long taskId);

    /**
     * 获取任务执行历史
     * 
     * @param semester 学期
     * @param limit 限制数量
     * @return 任务历史列表
     */
    public List<JwglScheduleTask> getTaskHistory(String semester, Integer limit);
}